Eine Strukturvorlage zur effektiven Dokumentation von Software- und IT Architekturen

IT-Entwicklungsprojekte verwenden heute immer noch ungebührlich viel Zeit zur Entwicklung projektspezifischer Strukturen für die Dokumentation von Softwareund IT-Architekturen. Durch die Verwendung von Strukturvorlagen lässt sich einerseits dieser Aufwand erheblich reduzieren, andererseits die Qualität von Architekturdokumentation deutlich steigern. Der Beitrag stellt die arc42-Schablone zur Architekturdokumentation vor, die sich in vielen kommerziellen, industriellen und Open-Source Projekten bewährt hat. 1 IT-Praxis benötigt Strukturvorlagen In vielen Projekten, in denen wir als Berater involviert werden, verwenden Mitarbeiter ungebührlich viel Zeit für die Entwicklung von Strukturen und Prozessen für die Dokumentation der jeweiligen Software-Architektur. Dabei besitzen gerade die Strukturen von Architekturdokumentation erhebliches Wiederverwendungspotenzial über die Grenzen einzelner Projekte hinweg: Theorie und Praxis sind sich über viele notwendige Merkmale und Bestandteile von Architekturdokumentation einig (siehe dazu insbesondere [Clements+02] sowie [Starke02]. Unter anderem gehören dazu: